ebab7d0da53c51438720d60c6e2e467c - /page/wikibook/entry.mu

Micron Document

<!DOCTYPE html>

</head>

</header>

</div>

<p><b>XML-RPC</b> est un protocole RPC (<i><a href="Remote_procedure_call" class="mw-redirect" title="Remote procedure call">remote procedure call</a></i>), une spécification simple et un ensemble de codes qui permettent à des processus s'exécutant dans des environnements différents de faire des appels de méthodes à travers un réseau.

</p><p>Ce protocole a été élaboré et publié dans sa première version en <a href="1998" title="1998">1998</a> par Dave Winer, travaillant pour UserLand Software<sup id="cite_ref-1" class="reference"><a href="#cite_note-1"><span class="cite-bracket">[</span>1<span class="cite-bracket">]</span></a></sup>, en collaboration avec <a href="Microsoft" title="Microsoft">Microsoft</a><sup id="cite_ref-2" class="reference"><a href="#cite_note-2"><span class="cite-bracket">[</span>2<span class="cite-bracket">]</span></a></sup>.

</p><p>XML-RPC permet d'appeler une fonction sur un serveur distant à partir de n'importe quel système (<a href="Microsoft_Windows" title="Microsoft Windows">Windows</a>, <a href="MacOS" title="MacOS">Mac OS X</a>, GNU/Linux) et avec n'importe quel <a href="Langage_de_programmation" title="Langage de programmation">langage de programmation</a>. Le serveur est lui-même sur n'importe quel système et est programmé dans n'importe quel langage.

</p><p>Cela permet de fournir un <a href="Service_web" title="Service web">service web</a> utilisable par tout le monde sans restriction de système ou de langage.

</p><p>Les processus d'invocation à distance utilisent le protocole <a href="HTTP" class="mw-redirect" title="HTTP">HTTP</a> pour le transfert des <a href="Donn%C3%A9e_(informatique)" title="Donnée (informatique)">données</a> et la norme <a href="Extensible_Markup_Language" title="Extensible Markup Language">XML</a> pour la structuration des <a href="Donn%C3%A9e_(informatique)" title="Donnée (informatique)">données</a>.

</p><p>XML-RPC est conçu pour permettre à des <a href="Structures_de_donn%C3%A9es" class="mw-redirect" title="Structures de données">structures de données</a> complexes d'être transmises, exécutées et renvoyées très facilement.

</p><p>XML-RPC est une alternative aux <a href="Service_web#Services_web_WS-*" title="Service web">services web WS-*</a>, dont <a href="SOAP" title="SOAP">SOAP</a>.

</p>

<div class="mw-heading mw-heading2"><h2 id="Usage[3]"><span id="Usage.5B3.5D"></span>Usage<sup id="cite_ref-3" class="reference"><a href="#cite_note-3"><span class="cite-bracket">[</span>3<span class="cite-bracket">]</span></a></sup></h2></div>

<p>Pour effectuer un appel XML-RPC, un client doit effectuer une <a href="Hypertext_Transfer_Protocol" title="Hypertext Transfer Protocol">requête POST</a> de type <i>text/xml</i> avec un corps qui précise la méthode distante invoquée, et, s'il y en a, les paramètres à passer à cette méthode.

</p><p>Le serveur XML-RPC doit renvoyer une réponse avec le code <a href="Liste_des_codes_HTTP" title="Liste des codes HTTP">"200 OK"</a>, le type <i>text/xml</i>, et un corps qui peut contenir un unique paramètre. En cas d'erreur le corps peut à la place contenir une description de l'erreur. Une erreur est représentée par un code d'erreur sous forme d'un entier, et d'un <a href="Message_d'erreur" title="Message d'erreur">message d'erreur</a> sous forme de <a href="Cha%C3%AEne_de_caract%C3%A8res" title="Chaîne de caractères">chaîne de caractères</a>.

</p>

<div class="mw-heading mw-heading2"><h2 id="Exemple">Exemple</h2></div><p>

Imaginons un serveur xml-rpc qui comporterait une méthode <i>genereUnMessageDeSalutation</i> qui prend comme paramètre un nom et qui retour un message de salutation en conséquence. Une requête pour invoquer cette méthode aurait le corps</p><div class="mw-highlight mw-highlight-lang-xml mw-content-ltr" dir="ltr"><pre><span></span><span class="cp"><?xml version="1.0"?></span>

<span class="w"> </span><span class="nt"><methodName></span>genereUnMessageDeSalutation<span class="nt"></methodName></span>

</pre></div><p>et la réponse ressemblerait à</p><div class="mw-highlight mw-highlight-lang-xml mw-content-ltr" dir="ltr"><pre><span></span><span class="cp"><?xml version="1.0"?></span>

<span class="w"> </span><span class="nt"><value><string></span>Bonjour<span class="w"> </span>Paul<span class="nt"></string></value></span>

</pre></div>

<div class="mw-heading mw-heading2"><h2 id="Types_de_données"><span id="Types_de_donn.C3.A9es"></span><a href="Type_(informatique)" title="Type (informatique)">Types de données</a></h2></div>

<p>Les types de données qui existent dans la spécification xml-rpc sont :

</p>

</caption>

<th>Nom

</th>

<th>Exemple

</th>

<th>Commentaire

</th></tr>

<tr>

<td>Entier

</td>

</pre></div>ou<div class="mw-highlight mw-highlight-lang-xml mw-content-ltr" dir="ltr"><pre><span></span><span class="nt"><int></span>-666<span class="nt"></int></span>

</pre></div>

</td>

<td>Entier signé sur 4 <a href="Byte" title="Byte">bytes</a>

</td></tr>

<tr>

<td><a href="Bool%C3%A9en" title="Booléen">Booléen</a>

</td>

</pre></div>ou<div class="mw-highlight mw-highlight-lang-xml mw-content-ltr" dir="ltr"><pre><span></span><span class="nt"><boolean></span>1<span class="nt"></boolean></span>

</pre></div>

</td>

<td>0 représente l'état "faux", 1 représente l'état "vrai"

</td></tr>

<tr>

<td>Chaîne de caractères

</td>

</pre></div>

</td>

<td>

</td></tr>

<tr>

<td>Nombre à virgule

</td>

</pre></div>

</td>

<td>double signé

</td></tr>

<tr>

<td>Date et heure

</td>

</pre></div>

</td>

<td>Date et heure au format <a href="ISO_8601" title="ISO 8601">ISO 8601</a>

</td></tr>

<tr>

<td>Données binaires

</td>

<td><div class="mw-highlight mw-highlight-lang-xml mw-content-ltr" dir="ltr"><pre><span></span><span class="nt"><base64></span>dW4gdGV4dGUgc2FucyBpbnTDqXLDqnQ=<span class="nt"></base64></span>

</pre></div>

</td>

<td>Donées binaires encodées en <a href="Base64" title="Base64">base64</a>

</td></tr>

<tr>

<td>Structure de données

</td>

</pre></div>

</td>

<td>Chaque membre de la structure de données a un nom et une valeur.

<p>Un membre peut être de n'importe quel type. Il peut aussi être lui même une structure de données

</p>

</td></tr>

<tr>

<td>Tableau

</td>

</pre></div>

</td>

<td>Les types de valeur du tableau peuvent de n'importe quel type et peuvent être hétérogènes

</td></tr></tbody></table>

<p>Une extension de la spécification introduit le type de données <i><nil /></i> qui permet de représenter une absence de valeur<sup id="cite_ref-4" class="reference"><a href="#cite_note-4"><span class="cite-bracket">[</span>4<span class="cite-bracket">]</span></a></sup>. Il n'est toutefois pas garanti qu'un serveur XML-RPC accepte ce type de données sur tous ses champs.

</p><p>Par ailleurs, bien que ne faisant pas partie de la spécification, certaines implémentations acceptent le type de données <i><i8></i> pour représenter les entiers signés codés sur 8 bytes<sup id="cite_ref-5" class="reference"><a href="#cite_note-5"><span class="cite-bracket">[</span>5<span class="cite-bracket">]</span></a></sup><sup class="reference cite_virgule">,</sup><sup id="cite_ref-6" class="reference"><a href="#cite_note-6"><span class="cite-bracket">[</span>6<span class="cite-bracket">]</span></a></sup>.

</p>

<div class="mw-heading mw-heading2"><h2 id="Critiques">Critiques</h2></div>

<p>Des critiques à l'encontre de XLM-RPC font valoir qu'il n'a qu'une faible valeur ajoutée par rapport à du simple XML ou par rapport à une API <a href="Representational_state_transfer" title="Representational state transfer">Rest</a>. Notamment une requête XML-RPC est environ 4 fois plus grosse qu'une requête en simple XML qui encoderait les mêmes objets<sup id="cite_ref-7" class="reference"><a href="#cite_note-7"><span class="cite-bracket">[</span>7<span class="cite-bracket">]</span></a></sup><sup class="reference cite_virgule">,</sup><sup id="cite_ref-8" class="reference"><a href="#cite_note-8"><span class="cite-bracket">[</span>8<span class="cite-bracket">]</span></a></sup><sup class="reference cite_virgule">,</sup><sup id="cite_ref-9" class="reference"><a href="#cite_note-9"><span class="cite-bracket">[</span>9<span class="cite-bracket">]</span></a></sup>.

</p>

<div class="mw-heading mw-heading2"><h2 id="Références"><span id="R.C3.A9f.C3.A9rences"></span>Références</h2></div>

<li id="cite_note-1"><span class="mw-cite-backlink"><a href="#cite_ref-1">↑</a> </span><span class="reference-text"><span class="ouvrage" id="Winer1999"><span class="ouvrage" id="Dave_Winer1999"><abbr class="abbr indicateur-langue" title="Langue : anglais">(en)</abbr> Dave Winer, « <a rel="nofollow" class="external text" href="http://1998.xmlrpc.com/"><cite style="font-style:normal;" lang="en">Home</cite></a> », <time class="nowrap" datetime="1999-06-14" data-sort-value="1999-06-14">14 juin 1999</time> <small style="line-height:1em;">(consulté le <time class="nowrap" datetime="2024-05-25" data-sort-value="2024-05-25">25 mai 2024</time>)</small></span></span></span>

</li>

<li id="cite_note-2"><span class="mw-cite-backlink"><a href="#cite_ref-2">↑</a> </span><span class="reference-text"><span class="ouvrage" id="Winer14/07.1998"><span class="ouvrage" id="Dave_Winer14/07.1998"><abbr class="abbr indicateur-langue" title="Langue : anglais">(en)</abbr> Dave Winer, « <a rel="nofollow" class="external text" href="http://scripting.com/davenet/1998/07/14/xmlRpcForNewbies.html"><cite style="font-style:normal;" lang="en">XML-RPC for Newbies</cite></a> », 14/07.1998 <small style="line-height:1em;">(consulté le <time class="nowrap" datetime="2014-05-25" data-sort-value="2014-05-25">25 mai 2014</time>)</small></span></span></span>

</li>

<li id="cite_note-3"><span class="mw-cite-backlink"><a href="#cite_ref-3">↑</a> </span><span class="reference-text"><span class="ouvrage"><abbr class="abbr indicateur-langue" title="Langue : anglais">(en)</abbr> « <a rel="nofollow" class="external text" href="https://xmlrpc.com/spec.md"><cite style="font-style:normal;" lang="en">XML-RPC Specification</cite></a> » <small style="line-height:1em;">(consulté le <time class="nowrap" datetime="2025-04-13" data-sort-value="2025-04-13">13 avril 2025</time>)</small></span></span>

</li>

<li id="cite_note-4"><span class="mw-cite-backlink"><a href="#cite_ref-4">↑</a> </span><span class="reference-text"><span class="ouvrage"><abbr class="abbr indicateur-langue" title="Langue : anglais">(en)</abbr> « <a rel="nofollow" class="external text" href="https://web.archive.org/web/20130120074804/http://ontosys.com/xml-rpc/extensions.php"><cite style="font-style:normal;" lang="en">XML-RPC Extensions</cite></a> » <small style="line-height:1em;">(consulté le <time class="nowrap" datetime="2025-04-13" data-sort-value="2025-04-13">13 avril 2025</time>)</small></span></span>

</li>

<li id="cite_note-5"><span class="mw-cite-backlink"><a href="#cite_ref-5">↑</a> </span><span class="reference-text"><span class="ouvrage"><abbr class="abbr indicateur-langue" title="Langue : anglais">(en)</abbr> « <a rel="nofollow" class="external text" href="https://metacpan.org/pod/RPC::XML"><cite style="font-style:normal;" lang="en">RPC::XML - A set of classes for core data, message and XML handling - metacpan.org</cite></a> » <small style="line-height:1em;">(consulté le <time class="nowrap" datetime="2025-04-13" data-sort-value="2025-04-13">13 avril 2025</time>)</small></span></span>

</li>

<li id="cite_note-6"><span class="mw-cite-backlink"><a href="#cite_ref-6">↑</a> </span><span class="reference-text"><span class="ouvrage"><abbr class="abbr indicateur-langue" title="Langue : anglais">(en)</abbr> « <a rel="nofollow" class="external text" href="https://xmlrpc-c.sourceforge.io/doc/libgeneral.html"><cite style="font-style:normal;" lang="en">User manual for XML-RPC For C/C++</cite></a> » <small style="line-height:1em;">(consulté le <time class="nowrap" datetime="2025-04-13" data-sort-value="2025-04-13">13 avril 2025</time>)</small></span></span>

</li>

<li id="cite_note-7"><span class="mw-cite-backlink"><a href="#cite_ref-7">↑</a> </span><span class="reference-text"><span class="ouvrage"><abbr class="abbr indicateur-langue" title="Langue : anglais">(en)</abbr> « <a rel="nofollow" class="external text" href="https://stackoverflow.com/questions/1376688/what-is-the-benefit-of-xml-rpc-over-plain-xml"><cite style="font-style:normal;" lang="en">What is the benefit of XML-RPC over plain XML?</cite></a> » <small style="line-height:1em;">(consulté le <time class="nowrap" datetime="2025-04-14" data-sort-value="2025-04-14">14 avril 2025</time>)</small></span></span>

</li>

<li id="cite_note-8"><span class="mw-cite-backlink"><a href="#cite_ref-8">↑</a> </span><span class="reference-text"><span class="ouvrage"><abbr class="abbr indicateur-langue" title="Langue : anglais">(en)</abbr> « <a rel="nofollow" class="external text" href="https://www.intertwingly.net/wiki/pie/XmlRpcDiscussion?action=show&redirect=DontUseXmlRpc"><cite style="font-style:normal;" lang="en">"An open poll on the merits of XmlRpc versus alternatives</cite></a> » <small style="line-height:1em;">(consulté le <time class="nowrap" datetime="2025-04-14" data-sort-value="2025-04-14">14 avril 2025</time>)</small></span></span>

</li>

<li id="cite_note-9"><span class="mw-cite-backlink"><a href="#cite_ref-9">↑</a> </span><span class="reference-text"><span class="ouvrage"><abbr class="abbr indicateur-langue" title="Langue : anglais">(en)</abbr> « <a rel="nofollow" class="external text" href="https://web.archive.org/web/20130511053512/http://joncanady.com/blog/2010/01/14/if-you-have-rest-why-xml-rpc/"><cite style="font-style:normal;" lang="en">If you have REST, why XML-RPC?</cite></a> » <small style="line-height:1em;">(consulté le <time class="nowrap" datetime="2025-04-14" data-sort-value="2025-04-14">14 avril 2025</time>)</small></span></span>

</li>

</ol></div>

</div>

<div class="mw-heading mw-heading2"><h2 id="Liens_externes">Liens externes</h2></div>

<ul><li><abbr class="abbr indicateur-langue" title="Langue : anglais">(en)</abbr> <a rel="nofollow" class="external text" href="http://xmlrpc.com/">XML-RPC Home Page</a>, spécification et également implémentations dans divers langages</li>

<li><abbr class="abbr indicateur-langue" title="Langue : anglais">(en)</abbr> <a rel="nofollow" class="external text" href="http://1998.xmlrpc.com/">XML-RPC Home page de 1998</a>, conservée par Dave Winer</li>

<li><abbr class="abbr indicateur-langue" title="Langue : anglais">(en)</abbr> <a rel="nofollow" class="external text" href="http://reboot.xmlrpc.com/">Rebooting XML-RPC</a>, évolution de XML-RPC par son créateur Dave Winer</li>

<li><abbr class="abbr indicateur-langue" title="Langue : anglais">(en)</abbr> <a rel="nofollow" class="external text" href="https://github.com/scripting/xml-rpc">Scripting/xml-rpc sur GIthub</a>, la version <a href="JavaScript" title="JavaScript">Javascript</a> de "Rebooting XML-RPC" par Dave Winer</li>

<li>Documentation avec exemples d'<a href="Impl%C3%A9mentation" class="mw-redirect" title="Implémentation">implémentation</a> en plusieurs langages : <a rel="nofollow" class="external free" href="http://www.tldp.org/HOWTO/XML-RPC-HOWTO/index.html">http://www.tldp.org/HOWTO/XML-RPC-HOWTO/index.html</a></li></ul>

</div>

<ul id="bandeau-portail" class="bandeau-portail"><li><span class="bandeau-portail-element"><span class="bandeau-portail-icone"><span class="noviewer" typeof="mw:File"></span></span> <span class="bandeau-portail-texte">Portail de l’informatique</span> </span></li> </ul></div><div><div class="zim-footer">

Cet article est issu de <a class="external text" title="Dernière modification le 2025-05-12" href="https://fr.wikipedia.org/wiki/?title=XML-RPC&oldid=225609299">Wikipédia</a>. Sauf mention contraire, le texte est disponible sous <a class="external text" href="https://creativecommons.org/licenses/by-sa/4.0/deed.fr">Creative Commons Attribution-Share Alike 4.0</a>. Des conditions supplémentaires peuvent s’appliquer aux fichiers multimédias.

</div>

</div></div>

</div>

</main>

</div>

</body></html>